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* 

expression calculator processes the relocations having an offset 0000 shown in 

... * 

Figure 7a. Thus, when the all the relocations at ofteet 0000 have been processed 
the top of the expression stack 34 contains the original expression. This is then 
retrieved by the expression calculator 32 and supplied to the disassembler 22 
together with the first instruction 100bOC8 . The resulting display is shown at the 
bottom of Figure 7a consisting of the program count A, the hexadecimal 
assembled object code B, the disassembled, instruction in source code 
corresponding to the hexadecimal object code (and including the final value 0 in 
the first instruction) and the expressions, d, which is used to calculate the value of 

0 in the first Instruction, derived from the relocation data by the expression 

• . * . ■• * • 

calculator and expression stack. . 

' ■ " ".- . . •- 

- - - . 

The example of Figure 7a similarly illustrates the same sequence with respect to 
the second instruction at program count 0004. 

• * »* ■ ■ • 

■ * ■ .-■•".-*•■" 

Figure 8 illustrates how the lister operates to deal with the second example 
discussed above. An object code module 3 contains the code sequence 
discussed above in relation to ^carnple 2. In line with Figure 5, the object code 
module includes a plurality of alternative sequences, denoted 01,02 in 
Figures 5 and 8. In this particular example, each code sequence is a single line 
of code. although it will readily be appreciated that a plurality of lines of code 
could be provided for each alternative code sequence . The relocation section is 
shown to include three conditional relocations; RjF, R_ELSE and R_ENDIF 
attached to the appropriate offsets for the p^tionaT code lines in the section data. 
When tile first optional code line Oi at program count 0008 is read by the data 
reader 11, the relocations reader d^entiines that ^ conditional relocation R IF fs 
present at the same offset, and suppBes the relocation to the directive processor 

• " " * ■ »""..* ■"•*.**. •* 

«. - • »■* - .- » , 

30. The directive processor uses this infprrnation to regenerate the conditional 
assembler directive which gave rise to the awiditiortal relocation. The conditional 

■ -.-■» * - . 

assembler directive and the instruction at program count 0008 are supplied to the 
disassembler. Beca u s e , conditional assembler directives are not executable 
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instructions themselves (that is they do not themselves form part of the 
executable program), when the source code containing the conditional assembler 
directives is assembled, the program counter is not incremented. Thus, the 
conditional assembler directive is displayed with a program count corresponding 
to that of the original optional code line. The same procedure is carried out for 
the optional code line 02 at program courit 0O0OC and also for the ending code 
line at program count 0010 which is likewise found to have a final conditional 
relocation RJENDIF at that offset 

■ " ■"• : ' ' ' " . 

• * ■ * 

Figure 9 illustrates how the lister operates to deal with events generated in 

.'•*."' • . . • ■ 

response to event relocations. Each instruction within a data section of the 

executable program may have one or more events associates with it denoted by 

the symbol 0 where 0 can .take any value of integer from 1 tp n. In the example 

illustrated Jn Figure 9 the instruction BAR 0 at program count 0000 is associated 

with the event ^ARNING^ where $ represents the 

- - * • - ■ t- ■ ■ . . • ■ • . ' * 

program count Initially the pperation of the lister is the sanrte as that described in 

relation to Figures 7a and 7b. The relocation reader 16 supplies the expression 

■ • * *• "*.*** » • * .* . ■ » 

relocations R_P US H to R_EQ having the same offset as the instruction to the 
expression calculator 32 which, using the expression stack 34 regenerates the 
initial expression. However when the eveht relocation REASSERT WARNING is 
received by the relocation reader 16 it is supplied to the event calculator 36. The 
event calculator retrieves the expression from the top of the expression stack 34, 
generates the event ^MRNlN$((<(P and places this on top of 

the event stack 38. tf any further events are associated with the same instruction 
these are then processed in turn and also placed on the event stack 38 so that 
when ail the events have been processed the event stack 38 will hold 0 events. 
When It Is detected that there are no more events associated with an instruction 
(determined by the relocation offset changing value), the events are popped from 

the event stack 38 and supplied to the disassembler 2? together with the ordinal 

- ■ * ■ ■ ■ 

instruction OOOOaOOO. 
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In the above description it has been assumed that the program count in the object 

code module is the same as the offset identified in the respective relocation. In 

fact however it will readily be appreciated that the offset identified in the relocation 

. ■ - ■ • *, 

can be taken from an index value representing the base of the object code 

module or the base of the particular section! Thus, the offset identified in the 

relocation merely allows the correct location in the section data to be identified 

and need not be identical to the program count Itself. 
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